package com.studyweb.mapper;

import com.studyweb.pojo.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 用户Mapper接口
 * 
 * @author StudyWeb Team
 * @since 1.0.0
 */
@Mapper
public interface UserMapper {
    
    /**
     * 插入用户
     * 
     * @param user 用户信息
     * @return 影响行数
     */
    int insert(User user);
    
    /**
     * 根据ID删除用户
     * 
     * @param userId 用户ID
     * @return 影响行数
     */
    int deleteById(Long userId);
    
    /**
     * 更新用户信息
     * 
     * @param user 用户信息
     * @return 影响行数
     */
    int update(User user);
    
    /**
     * 根据ID查询用户
     * 
     * @param userId 用户ID
     * @return 用户信息
     */
    User selectById(Long userId);
    
    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    User selectByUsername(String username);
    
    /**
     * 根据手机号查询用户
     * 
     * @param phone 手机号
     * @return 用户信息
     */
    User selectByPhone(String phone);
    
    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户信息
     */
    User selectByEmail(String email);
    
    /**
     * 查询所有用户
     * 
     * @return 用户列表
     */
    List<User> selectAll();
    
    /**
     * 根据条件查询用户列表
     * 
     * @param user 查询条件
     * @return 用户列表
     */
    List<User> selectByCondition(User user);
    
    /**
     * 查询用户总数
     * 
     * @return 用户总数
     */
    Long selectCount();
    
    /**
     * 更新最后登录时间
     * 
     * @param userId 用户ID
     * @param lastLoginTime 最后登录时间
     * @return 影响行数
     */
    int updateLastLoginTime(@Param("userId") Long userId, @Param("lastLoginTime") LocalDateTime lastLoginTime);
    
    /**
     * 更新密码
     * 
     * @param userId 用户ID
     * @param password 新密码
     * @return 影响行数
     */
    int updatePassword(@Param("userId") Long userId, @Param("password") String password);
    
    /**
     * 更新用户状态
     * 
     * @param userId 用户ID
     * @param status 状态
     * @return 影响行数
     */
    int updateStatus(@Param("userId") Long userId, @Param("status") Integer status);
    
    /**
     * 检查用户名是否存在
     * 
     * @param username 用户名
     * @return 存在数量
     */
    int countByUsername(String username);
    
    /**
     * 检查手机号是否存在
     * 
     * @param phone 手机号
     * @return 存在数量
     */
    int countByPhone(String phone);
    
    /**
     * 检查邮箱是否存在
     * 
     * @param email 邮箱
     * @return 存在数量
     */
    int countByEmail(String email);
}